home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / rtetc800.zip / RTDOCS.ZIP / RTRACE.LST next >
File List  |  1992-07-27  |  19KB  |  489 lines
  1.  
  2.                                                        RTRACE(1G)
  3.  
  4. NAME
  5.      rtrace - ray tracing program
  6.  
  7. SYNOPSIS
  8.      rtrace [options] scene image [>log]
  9.  
  10. AUTHOR
  11.      Antonio Costa, INESC-Norte, 1989 1992
  12.  
  13. DESCRIPTION
  14.      _r_t_r_a_c_e command performs ray tracing from a _S_F_F text file
  15.      which must describe a scene with objects, lights, surface
  16.      definitions, textures, etc.  This scene file must be in the
  17.      appropriate format, as described bellow.
  18.      Basically, ray tracing is an algorithm for the creation of
  19.      realistic images from the geometry and attributes of
  20.      objects, lights, etc.  This ray tracer supports several
  21.      types of objects (sphere, box, bicubic patch, cone,
  22.      cylinder, polygon, triangle and text), CSG and list opera-
  23.      tions, different light types, reasonable surface defini-
  24.      tions, lots of textures, several anti-aliasing schemes,
  25.      depth of field, stereoscopic image creation and so on...
  26.  
  27. OPTIONS
  28.      [w_i_m_a_g_e-_w_i_d_t_h] [h_i_m_a_g_e-_h_e_i_g_h_t]
  29.      The parameters _i_m_a_g_e-_w_i_d_t_h and _i_m_a_g_e-_h_e_i_g_h_t define the image
  30.      size. Defaults are 256x256.
  31.  
  32.      [A_a_l_i_a_s_i_n_g-_t_h_r_e_s_h_o_l_d]
  33.      [S_s_h_a_d_i_n_g-_t_h_r_e_s_h_o_l_d]
  34.      [T_a_m_b_i_e_n_t-_t_h_r_e_s_h_o_l_d]
  35.      The parameters _a_l_i_a_s_i_n_g-_t_h_r_e_s_h_o_l_d (pixel supersampling),
  36.      _s_h_a_d_i_n_g-_t_h_r_e_s_h_o_l_d (shading rays propagation) and _a_m_b_i_e_n_t-
  37.      _t_h_r_e_s_h_o_l_d (ambient rays distribution caching) control the
  38.      image quality (0-best, 1-poor). Defaults are 0.05, 0.01 and
  39.      0 (no ambient threshold). Good ranges are 0.1-0.03, 0.01-
  40.      0.001 and 0.01-0.00001, respectively.
  41.  
  42.      [a_a_n_t_i_a_l_i_a_s_i_n_g-_m_o_d_e]
  43.      The parameter _a_n_t_i_a_l_i_a_s_i_n_g-_m_o_d_e chooses adaptive supersam-
  44.      pling antialiasing (0-default), semi-adaptive supersampling
  45.      antialiasing (1) or normal supersampling antialiasing (2-
  46.      should be used with nonzero focal apertures).
  47.  
  48.      [B_m_a_s_k_f_i_l_e]
  49.      The parameter _m_a_s_k_f_i_l_e creates a file with a background
  50.      mask, suitable for mixing images (it is like an alpha chan-
  51.      nel).
  52.  
  53.      [c_c_l_u_s_t_e_r-_s_i_z_e]
  54.      The parameter _c_l_u_s_t_e_r-_s_i_z_e controls the enclosing of objects
  55.      (number of grouped objects per cluster) in the object
  56.      hierarchy. Use a low value for sparse scenes, a high value
  57.      for dense scenes (4-default).
  58.  
  59.      [d_a_m_b_i_e_n_t-_l_e_v_e_l_s]
  60.      The parameter _a_m_b_i_e_n_t-_l_e_v_e_l_s defines the number of shading
  61.      levels (shading tree depth) in which ambient lighting
  62.      calculations will be done through ray distribution (0-
  63.      default, ie, no ray distribution). Use low values!
  64.  
  65.      [D_a_m_b_i_e_n_t-_s_a_m_p_l_e_s]
  66.      The parameter _a_m_b_i_e_n_t-_s_a_m_p_l_e_s defines the maximum number of
  67.      distributed rays to be used in ambient lighting calculations
  68.      (16-default). Again, use with care.
  69.  
  70.      [i_i_n_t_e_r_s_e_c_t-_m_o_d_e]
  71.      The parameter _i_n_t_e_r_s_e_c_t-_m_o_d_e chooses, in adaptive supersam-
  72.      pling antialiasing, between testing all scene objects (1) or
  73.      only the objects found at the pixel corners and inside (0-
  74.      default; this greatly reduces CPU time, but with very small
  75.      objects, it sometimes fails).
  76.  
  77.      [I_i_n_t_e_r_s_e_c_t-_a_d_j_u_s_t-_m_o_d_e]
  78.      The parameter _i_n_t_e_r_s_e_c_t-_a_d_j_u_s_t-_m_o_d_e avoids some problems
  79.      with invalid self-intersections (1) (0-default).  Scenes
  80.      with text objects should be traced with this parameter equal
  81.      to 1.
  82.  
  83.      [j_j_i_t_t_e_r_i_n_g-_m_o_d_e]
  84.      The parameter _j_i_t_t_e_r_i_n_g-_m_o_d_e chooses jittered sampling (1)
  85.      or not (0-default). Sometimes, activating it produces better
  86.      images from scenes with small tricky details.
  87.  
  88.      [l_l_i_g_h_t_i_n_g-_m_o_d_e]
  89.      The parameter _l_i_g_h_t-_m_o_d_e controls the generation of shadow
  90.      rays through non-opaque objects: 0-none (default), 1-
  91.      partial, 2-full. If a scene has translucent objects, to
  92.      obtain realism one should use 1 or 2 (better).
  93.  
  94.      [m_s_h_a_d_i_n_g-_m_o_d_e]
  95.      The parameter _s_h_a_d_i_n_g-_m_o_d_e chooses between shading models:
  96.      0-normal phong, 1-strauss (default but slower) (note: this
  97.      model was developed by Paul Strauss of SGI).
  98.  
  99.      [n_n_o_r_m_a_l-_m_o_d_e]
  100.      The parameter _n_o_r_m_a_l-_m_o_d_e controls the correction of surface
  101.      normals, so that it points against the incident ray: 0-
  102.      always (default), 1-only inside objects. With "correct"
  103.      objects, it is good to use 1.
  104.  
  105.      [z_n_o_r_m_a_l-_c_h_e_c_k-_m_o_d_e]
  106.      The parameter _n_o_r_m_a_l-_c_h_e_c_k-_m_o_d_e controls the correction of
  107.      surface normals when textures that modify the normal are
  108.      used, as they may sometimes create strange surface effects.
  109.      This tends to happen if the scale of the normal perturbation
  110.      is big.  0-no correction (default), 1-correction.
  111.  
  112.      [R_r_a_w_f_i_l_e]
  113.      The parameter _r_a_w_f_i_l_e creates a raw image file, without any
  114.      antialiasing (all defects show up!).
  115.  
  116.      [p_s_a_m_p_l_i_n_g-_l_e_v_e_l_s]
  117.      The parameter _s_a_m_p_l_i_n_g-_l_e_v_e_l_s controls the amount of sam-
  118.      pling levels inside pixels: 0-none ... 3-maximum (default).
  119.      A reasonable value is 2 for high resolutions, but for small
  120.      ones 3 gives better (and slower) results.
  121.  
  122.      [s_s_h_a_d_i_n_g-_l_e_v_e_l_s]
  123.      The parameter _s_h_a_d_i_n_g-_l_e_v_e_l_s establishes a maximum shading
  124.      tree depth (default is 8). When a scene has
  125.      transparent/reflective objects, it may be important to lower
  126.      this parameter, or else the tracing never stops. In the
  127.      other cases, there should be no problem allowing it to be
  128.      big.
  129.  
  130.      [t_t_e_x_t_u_r_e-_m_o_d_e]
  131.      The parameter _t_e_x_t_u_r_e-_m_o_d_e allows the definition of
  132.      texture(s) for the objects: 0-no textures (default), 1-with
  133.      textures defined inside objects field, 2-with textures
  134.      defined after objects field. As textures may consume much
  135.      CPU time, they should be activated only for final images.
  136.  
  137.      [v_v_i_e_w-_m_o_d_e]
  138.      The parameter _v_i_e_w-_m_o_d_e chooses the view mode: 0-normal
  139.      (default), 1-left eye, 2-right eye.
  140.  
  141.      [P_f_o_c_a_l-_a_p_e_r_t_u_r_e]
  142.      The parameter _f_o_c_a_l-_a_p_e_r_t_u_r_e defines the focal aperture of
  143.      the camera (default 0.0, ie, pinhole camera). If different
  144.      than zero, there is depth of field, and so adaptive super-
  145.      sampling antialiasing will not work well.
  146.  
  147.      [F_f_o_c_a_l-_d_i_s_t_a_n_c_e]
  148.      The parameter _f_o_c_a_l-_d_i_s_t_a_n_c_e defines the focal distance of
  149.      the camera (default is the distance from the eye point to
  150.      the look point).
  151.  
  152.      [E_s_t_e_r_e_o-_s_e_p_a_r_a_t_i_o_n]
  153.      The parameter _s_t_e_r_e_o-_s_e_p_a_r_a_t_i_o_n controls the separation
  154.      between the left and the right eye.  If negative, it
  155.      represents a percentage of the gaze distance.
  156.  
  157.      [O_o_u_t_p_u_t-_f_o_r_m_a_t]
  158.      The parameter _o_u_t_p_u_t-_f_o_r_m_a_t chooses between the PIC format
  159.      (0-default) or the PPM format (1).
  160.  
  161.      [V_v_e_r_b_o_s_e-_m_o_d_e]
  162.      The parameter _v_e_r_b_o_s_e-_m_o_d_e supresses any messages (0) or
  163.      shows listing of parameters (1), previous plus statistics
  164.      (2-default) or previous plus a line by line echo of the
  165.      tracing (3-default on DOS and trans